XML 模块总览 - Overview

本分类做什么

DOM 风格 的 XML 解析、遍历、增删改、属性、CDATA、注释、声明、XPath 式查询、合并与校验。适合 配置文件、简单数据交换；与 JSON 相比，模式与命名空间 更重，按需选用。

---

一、文档级

接口	差异
XmlCreateDocument	空文档。
XmlParse、XmlParseFile	从 字符串 或 文件 解析。
XmlToString、XmlSaveToFile	序列化输出。
XmlFree	释放文档。

---

二、树与元素

接口	用途
XmlGetRootElement、XmlInsertRootElement	根元素。
XmlCreateElement、XmlAppendChild、XmlRemoveChild	建节点与挂树。
XmlGetFirstChild、XmlGetNextSibling、XmlGetPreviousSibling、XmlGetLastChild、XmlGetParent	遍历 轴。
XmlFindElement、XmlFindElementByAttribute、XmlQueryElement	查找（含路径查询）。

---

三、内容与属性

接口	差异
XmlGetElementName、XmlGetElementText、XmlSetElementText	元素 名与文本。
XmlGetAttribute / XmlSetAttribute + 各类型 Int/Double/Bool/Int64	属性 强类型读写。
XmlHasAttribute、XmlDeleteAttribute、XmlGetAttributeNames、XmlGetAttributeCount	属性 元管理。

---

四、高级

接口	说明
XmlSetCDATA、XmlAddComment、XmlSetDeclaration	CDATA、注释、XML 声明。
XmlCloneElement、XmlCompareElements	克隆与比较。
XmlMergeDocuments、XmlValidate	合并与 校验。
XmlGetElementDepth、XmlGetElementPath	调试路径。
XmlGetObjectCount、XmlCleanupAll	对象池/清理（见详情页）。

---

五、与 JSON 选型

场景	更倾向
配置需 DTD/Schema、编辑器格式化	XML
前后端、REST 默认	JSON

---

六、错误码

多数接口通过 err 输出参数 或 返回值 返回 XMLError 错误码（0 成功，非 0 失败）。读写失败时须检查错误码，勿单独依赖句柄或指针是否为 0 / NULL。

错误码	含义
0	成功
1	无效句柄
2	解析失败
3	类型不匹配
4	元素不存在
5	属性不存在
6	未知错误

---

七、注意

• 大文件 解析内存；XXE 若插件未禁用，勿解析不可信源。